home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
cvcov.z
/
cvcov
Wrap
Text File
|
1998-10-30
|
38KB
|
991 lines
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
NNNNAAAAMMMMEEEE
cvcov - The WorkShop Test Coverage Tool
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
ccccvvvvccccoooovvvv ----vvvveeeerrrr | _s_u_b_c_o_m_m_a_n_d ...
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
ccccvvvvccccoooovvvv invokes the command line version of the WorkShop Tester dynamic
test coverage tool. ccccvvvvxxxxccccoooovvvv invokes the GUI version of the same tool.
All functionality is available from either program. Some of the
graphical representations of the data will be available only from ccccvvvvxxxxccccoooovvvv....
For more information on using ccccvvvvccccoooovvvv please refer to the
"_C_A_S_E_V_i_s_i_o_n/_W_o_r_k_S_h_o_p _T_e_s_t_e_r _U_s_e_r'_s _G_u_i_d_e."
For installation of ccccvvvvccccoooovvvv please refer to the "_W_o_r_k_S_h_o_p _T_e_s_t_e_r _R_e_l_e_a_s_e
_N_o_t_e_s."
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----vvvveeeerrrr
Print the program version to stdout.
aaaaddddddddtttteeeesssstttt _t_e_s_t__n_a_m_e _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
Add the test or test set to the specified test set.
_t_e_s_t__n_a_m_e
Name of test or testset to add.
_t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
Name of testset or test group which is modified.
ccccaaaatttttttteeeesssstttt [ ----rrrr ] _t_e_s_t__n_a_m_e
Describe the test details for test_name.
----rrrr
Recursively print out details of subtests of this test. This
is useful if the test is a test set.
_t_e_s_t__n_a_m_e
Name of test to describe.
ddddeeeelllltttteeeesssstttt _t_e_s_t__n_a_m_e _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
PPPPaaaaggggeeee 1111
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
Delete the test or test set from the specified test set.
_t_e_s_t__n_a_m_e
Name of test or testset to remove.
_t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
Name of testset or test group which is modified.
ddddiiiiffffffff [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffuuuunnnnccccttttiiiioooonnnnssss ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt
function|diff ] _e_x_p_e_r_i_m_e_n_t_1 _e_x_p_e_r_i_m_e_n_t_2
List the differences in two test experiments.
----aaaarrrrgggg
Show arguments for functions.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ffffuuuunnnnccccttttiiiioooonnnnssss
Show differences for functions along with summary.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssoooorrrrtttt function|diff
function sorts alphabetically by function name. diff sorts by
differences in the counting information for all types of
coverage (TBD).
_e_x_p_e_r_i_m_e_n_t_1 and _e_x_p_e_r_i_m_e_n_t_2
Specify the two test experiment directories to make the
comparison.
hhhheeeellllpppp [ _c_o_m_m_a_n_d__n_a_m_e ]
Print help on the specified command. If the optional command
name is not specified, it prints help for all the commands.
_c_o_m_m_a_n_d__n_a_m_e
PPPPaaaaggggeeee 2222
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
Name of command which requires help.
llllssssaaaarrrrcccc [ ----aaaarrrrgggg ] [ ----ccccaaaalllllllleeeeeeee _c_a_l_l_e_e__p_a_t_t_e_r_n ] [ ----ccccaaaalllllllleeeerrrr _c_a_l_l_e_r__p_a_t_t_e_r_n ] [
----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt caller|callee|count ]
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
List function arcs coverage. Arcs are calls from one function
to another.
----aaaarrrrgggg
Show arguments for functions.
----ccccaaaalllllllleeeeeeee _c_a_l_l_e_e__p_a_t_t_e_r_n
Show the arcs with callee_pattern as callee. Note, function
patterns are of the form: [dso|executable]:{function|*}. For
example, "/usr/lib/libc.so.1:*" refers to all functions in the
dynamically shared object for the C library.
----ccccaaaalllllllleeeerrrr _c_a_l_l_e_r__p_a_t_t_e_r_n
Show the arcs with caller_pattern as caller. See the previous
discussion of function patterns.
----ccccoooonnnnttttrrrriiiibbbb
Show the list of tests that contributed to coverage for each
arc.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssoooorrrrtttt caller|callee|count
Sort the output on caller, callee or arc count.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssbbbblllloooocccckkkk [ ----aaaaddddddddrrrr ] [ ----aaaarrrrgggg ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt
_f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|count|file ]
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
PPPPaaaaggggeeee 3333
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
List basic block count information in the function. Blocks are
shown as line number sequences.
----aaaaddddddddrrrr
Show basic block by PC range instead of source line number
range.
----aaaarrrrgggg
Show arguments for functions.
----ccccoooonnnnttttrrrriiiibbbb
Show the list of tests that contributed to coverage for each
block.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
Specify function name for coverage. See the previous
discussion of function patterns.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssoooorrrrtttt function|count|file
Sort the output on function name, count or file name.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssbbbbrrrraaaannnncccchhhh [ ----aaaaddddddddrrrr ] [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [
----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
List count information for assembly language branch
instructions.
----aaaaddddddddrrrr
Show branch by PC instead of source line number.
PPPPaaaaggggeeee 4444
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
----aaaarrrrgggg
Show arguments for functions.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
Specify function name for coverage. See the previous
discussion of function patterns.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssoooorrrrtttt function|file
Sort the output on function name or file name.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssccccaaaallllllll [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----nnnnooooddddeeee _f_u_n_c__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----rrrr ]
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
List function call graph.
----aaaarrrrgggg
Show arguments for functions.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----nnnnooooddddeeee _f_u_n_c__n_a_m_e
Show the call graph starting from func_name subnode
recursively.
----pppprrrreeeettttttttyyyy
Column aligned output.
PPPPaaaaggggeeee 5555
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
----rrrr
Show all the subnodes of the call graph recursively.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssffffuuuunnnn [ ----aaaarrrrgggg ] [ ----bbbbffff _f_i_l_t_e_r__t_y_p_e _b_l_o_c_k__f_i_l_t_e_r__v_a_l_u_e ] [ ----bbbblllloooocccckkkkssss ] [
----bbbbrrrraaaannnncccchhhheeeessss ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffffff _f_i_l_t_e_r__t_y_p_e
_f_u_n_c__f_i_l_t_e_r__v_a_l_u_e ] [ ----ppppaaaatttt _p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----rrrrffff _f_i_l_t_e_r__t_y_p_e
_b_r_a_n_c_h__f_i_l_t_e_r__v_a_l_u_e ] [ ----ssssoooorrrrtttt function|count|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
List function coverage.
----aaaarrrrgggg
Show arguments for functions.
----bbbbffff _f_i_l_t_e_r__t_y_p_e _b_l_o_c_k__f_i_l_t_e_r__v_a_l_u_e
Filter for block where block_filter_value ranges between 0 and
1. Filter type is same as function filter_type.
For example, list the functions whose block coverage is less
than 25 percent:
cvcov lsfun -bf "<" .25 test_name
----bbbblllloooocccckkkkssss
Show block coverage for each function.
----bbbbrrrraaaannnncccchhhheeeessss
Show branch coverage for each function.
----ccccoooonnnnttttrrrriiiibbbb
Show the list of tests that contributed to coverage for each
function.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ffffffff _f_i_l_t_e_r__t_y_p_e _f_u_n_c__f_i_l_t_e_r__v_a_l_u_e
PPPPaaaaggggeeee 6666
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
Filter for function, where filter type is one of the following
"<","=", ">", "!=", "<=" and ">=". func_filter_value is the
threshold value.
For example, list only the functions whose count = 0 and sort
the output on function name:
cvcov lsfun -ff "=" 0 -sort function test_name
----ppppaaaatttt _p_a_t_t_e_r_n
Specify individual functions by pattern. See the previous
discussion of function patterns.
----pppprrrreeeettttttttyyyy
Column aligned output.
----rrrrffff _f_i_l_t_e_r__t_y_p_e _b_r_a_n_c_h__f_i_l_t_e_r__v_a_l_u_e
Filter for branch coverage where branch_filter_value ranges
between 0 and 1. Filter type is same as function filter_type.
For example, list the functions whose branch coverage is
greater than 75 percent.
cvcov lsfun -rf ">" .75 test_name
----ssssoooorrrrtttt function|count|file
List the functions sorted on function name, count or file name.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssiiiinnnnssssttttrrrr [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffuuuunnnnccccttttiiiioooonnnnssss ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _t_e_s_t__n_a_m_e
Display the instrumentation information for a particular test.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ffffuuuunnnnccccttttiiiioooonnnnssss
Show the functions that are included in the coverage
experiment.
PPPPaaaaggggeeee 7777
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r
Specify the version of the program that was instrumented.
tttteeeesssstttt____nnnnaaaammmmeeee
Specify the test directory.
llllsssslllliiiinnnneeee [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [
----ssssoooorrrrtttt _f_u_n_c_t_i_o_n|_f_i_l_e ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
List the coverage for native source lines.
----aaaarrrrgggg
Show arguments for functions.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
Specify function name for coverage. See the previous
discussion of function patterns.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssoooorrrrtttt function|file
Sort the output on either function or file name.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssssssoooouuuurrrrcccceeee [ ----aaaassssmmmm ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] _f_u_n_c_t_i_o_n _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Display source for function with line count (block count)
information. 0 counted lines are highlighted.
----aaaassssmmmm
Show assembly level source code.
PPPPaaaaggggeeee 8888
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
_f_u_n_c_t_i_o_n
Specify the function name to be displayed.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllssssssssuuuummmm [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----wwwweeeeiiiigggghhhhtttt
_f_u_n_c__f_a_c_t_o_r:_l_i_n_e__f_a_c_t_o_r:_b_r_a_n_c_h__f_a_c_t_o_r:_a_r_c__f_a_c_t_o_r:_b_l_o_c_k__f_a_c_t_o_r ]
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
List the summary of overall coverage for this run. Also list
the function, line, arc, branch, and block coverage.
----wwwweeeeiiiigggghhhhtttt
_f_u_n_c__f_a_c_t_o_r:_l_i_n_e__f_a_c_t_o_r:_b_r_a_n_c_h__f_a_c_t_o_r:_a_r_c__f_a_c_t_o_r:_b_l_o_c_k__f_a_c_t_o_r
Specify the weight factors for calculating overall coverage
based on individual coverages for function, line, branch, arc,
and block. The weights should add up to 1.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test experiment directory or test directory. If
test_name is specified, the latest (newest) test experiment in
the test directory will be used.
llllsssstttteeeesssstttt [ ----rrrr ] [_t_e_s_t__n_a_m_e ...]
List the coverage tests.
----rrrr
Recursively walk the directory and list all coverage tests.
_t_e_s_t__n_a_m_e ...
If testname or pattern is specified, list all tests which
match. If no testname is specified, list all tests in the
current working directory.
llllssssttttrrrraaaacccceeee [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt
function|type ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
PPPPaaaaggggeeee 9999
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
Trace function argument coverage.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for query. If no
executable is specified, the main program is the default.
----ppppaaaatttt _f_u_n_c__n_a_m_e
Function name for argument tracing. See the previous
discussion of function patterns.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssoooorrrrtttt function|type
Sort the output on either function name or argument type.
_e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
Specify the test directory or test directory. If test_name is
specified, the latest (newest) test experiment in the test
directory will be used.
mmmmkkkktttteeeesssstttt ----ccccmmmmdddd '_c_m_d__l_i_n_e' [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r ] [
----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ] [ _e_x_e_1 _e_x_e_2 ... ]
Create a test directory which contains a Test Description File.
----ccccmmmmdddd '_c_m_d__l_i_n_e'
Specify the program and command line options for the program to
be tested. This includes any redirection for stdin, stderr, or
stdout as run from the Bourne shell. The "cmd_line" is
mandatory, even if it only includes the program name.
----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n'
Specify the test description in single quotes.
----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r
Specify the instrumentation directory. If not specified,
mktest looks for the instrumentation directory in the current
working directory.
----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t
PPPPaaaaggggeeee 11110000
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
Specify the testname. If not specified, mktest creates a unique
name as well as the test directory.
_e_x_e_1 _e_x_e_2 ...
Specify the executables to be covered for this test. This
handles programs that cause other programs to be run (e.g.,
fork/exec). If no executable is specified, the main program is
the default.
mmmmkkkkttttggggrrrroooouuuupppp [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----lllliiiisssstttt _l_i_s_t__f_i_l_e ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ]
_t_a_r_g_e_t_1 _t_a_r_g_e_t_2 ...
Create a test group which can contain other tests or test
groups. A test group is a collection of programs which share
some libraries or dynamically shared objects in common. The
coverage is targeted for the shared libraries.
----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n'
Specify the test set description in single quotes.
----lllliiiisssstttt _l_i_s_t__f_i_l_e
Specify the file containing a list of test names to be made
part of the test set. If no -list option is specified an empty
test set will be created.
----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t
Specify the test set name. If not specified, mktset creates a
unique name as well as the test directory.
_t_a_r_g_e_t_1 _t_a_r_g_e_t_2 ...
Specify the target libraries or dynamically shared objects.
mmmmkkkkttttsssseeeetttt [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----lllliiiisssstttt _l_i_s_t__f_i_l_e ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ]
Create a test set which can contain other tests or test sets as
subtests. Specify the test set name, otherwise command will
automatically assign a test name for the test set.
----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n'
Specify the test set description in single quotes.
----lllliiiisssstttt _l_i_s_t__f_i_l_e
Specify the file containing a list of test names to be made
part of the test set. If no -list option is specified an empty
test set will be created.
PPPPaaaaggggeeee 11111111
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t
Specify the test set name. If not specified, mktset creates a
unique name as well as the test directory.
ooooppppttttiiiimmmmiiiizzzzeeee [ ----bbbblllloooocccckkkkssss ] [ ----bbbbrrrraaaannnncccchhhheeeessss ] [ ----ccccbbbbbbbb _f_i_l_t_e_r__t_y_p_e _b_b__f_i_l_t_e_r__v_a_l_u_e ] [
----ccccbbbbrrrr _f_i_l_t_e_r__t_y_p_e _b_r__f_i_l_t_e_r__v_a_l_u_e ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssttttaaaatttt ] _e_x_p_e_r_i_m_e_n_t ...|_t_e_s_t__n_a_m_e ...
Choose the minimum set of tests that give the same coverage or
meet the given coverage criteria
----bbbblllloooocccckkkkssss
Show block coverage for all the selected tests
----bbbbrrrraaaannnncccchhhheeeessss
Show branch coverage for all the selected tests
----ccccbbbbbbbb _f_i_l_t_e_r__t_y_p_e _b_b__f_i_l_t_e_r__v_a_l_u_e
Give the basic-block coverage criteria for test selection. The
rules are the same as the option ----bbbbffff of llllssssffffuuuunnnn command.
----ccccbbbbrrrr _f_i_l_t_e_r__t_y_p_e _b_r__f_i_l_t_e_r__v_a_l_u_e
Give the branch coverage criteria for test selection. The
rules are the same as the option ----rrrrffff of llllssssffffuuuunnnn command.
----eeeexxxxeeee _e_x_e__n_a_m_e
Specify which executable is targeted for test optimization. If
no executable is specified, the main program is the default.
----ppppaaaatttt _p_a_t_t_e_r_n
Specify DSO patterns for calculation of coverage on test
selection. See the previous discussion of function patterns.
----pppprrrreeeettttttttyyyy
Column aligned output.
----ssssttttaaaatttt
Print out block and branch coverage for all the selected tests.
Without this option, cumulative coverages for block and branch
are given.
PPPPaaaaggggeeee 11112222
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
_e_x_p_e_r_i_m_e_n_t ...|_t_e_s_t__n_a_m_e ...
names of experiments or tests to optimize
rrrrmmmmtttteeeesssstttt [ ----rrrr ] _t_e_s_t__n_a_m_e
Remove the test with the test_name specified.
----rrrr
Recursively remove all the subtests of the test testname. This
is useful for removing all the subtests of a test set.
_t_e_s_t__n_a_m_e
Name of test to remove.
rrrruuuunnnniiiinnnnssssttttrrrr [ ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r ] [ ----iiiinnnnssssttttrrrr____ffffiiiilllleeee _i_n_s_t_r__f_i_l_e ] [ ----vvvv
_v_e_r_s_i_o_n_n_u_m_b_e_r ] _e_x_e_c_u_t_a_b_l_e
Instrument the user <executable> based on the user selectable
criteria. The instrument file is an ASCII description of the
instrumentation criteria for the experiment. A complete
description of the instrument file can be found in the
"_W_o_r_k_S_h_o_p/_T_e_s_t_e_r _U_s_e_r'_s _G_u_i_d_e".
----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r
Specify the instrumentation directory.
----iiiinnnnssssttttrrrr____ffffiiiilllleeee _i_n_s_t_r__f_i_l_e
Specify the instrument file to be used to instrument
<executable>.
----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r
Specify the version of the program to be instrumented.
_e_x_e_c_u_t_a_b_l_e
Name of program that is being instrumented.
rrrruuuunnnntttteeeesssstttt [ ----bbbbiiiittttccccoooouuuunnnntttt ] [ ----ccccoooommmmpppprrrreeeessssssss ] [ ----ffffoooorrrrcccceeee ] [ ----kkkkeeeeeeeepppp ] [ ----nnnnooooaaaarrrrcccc ] [
----rrrrmmmmssssuuuubbbb ] [ ----ssssuuuummmm ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _t_e_s_t__n_a_m_e
Run a test or a test set.
----bbbbiiiittttccccoooouuuunnnntttt
PPPPaaaaggggeeee 11113333
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
Compress count data file to be 1-bit-per-count. This option
will decrease the data base size up to 32 times, but branch
count information will be lost.
----ccccoooommmmpppprrrreeeessssssss
Compress experiment database using standard utility ccccoooommmmpppprrrreeeessssssss....
----ffffoooorrrrcccceeee
Force the test to be run again even if a test experiment is
present.
----kkkkeeeeeeeepppp
Retain all performance data collected in the experiment. By
default, the performance data is not retained, because it is
not required by the coverage tool.
----nnnnooooaaaarrrrcccc
Do not capture arc information in the runtest experiment. The
arc data can potentially use of large amounts of disk space.
----rrrrmmmmssssuuuubbbb
Remove results for individual subtests if this is a test set or
test group. The overall test set or test group data is
retained.
----ssssuuuummmm
Accumulate (sum over) the coverage data into the existing
experiment results. This allows users to run and re-run the
same test and accumulate the results in one place.
----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r
Specify the version of the program to be run. If not
specified, runtest assumes the latest version of the program.
_t_e_s_t__n_a_m_e
Name of test to run.
FFFFIIIILLLLEEEESSSS
////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////CCCCvvvvxxxxccccoooovvvv
Application defaults for GUI program, cvxcov.
////uuuussssrrrr////TTTTeeeesssstttteeeerrrr////ddddeeeeffffaaaauuuulllltttt____iiiinnnnssssttttrrrr____ffffiiiilllleeee
Default instrument file.
PPPPaaaaggggeeee 11114444
CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111))))
SSSSEEEEEEEE AAAALLLLSSSSOOOO
cvxcov(1), cvd(1), cvinstr(1), cvperf(1), cvxhang(1)
PPPPaaaaggggeeee 11115555
